package com.kaikeba.dao;

import com.kaikeba.bean.Express;
import com.kaikeba.exciption.CodeException;

import java.util.List;
import java.util.Map;

public interface BaseExpressDao {

    /**
     * 用于查询数据库中的全部快递（总数 + 新增）
     * 待取件快递（总数 + 新增）
     * @return [{size:总数,day:新增},{size:总数,day:新增}]
     */
    List<Map<String,Integer>> console();

    /**
     * 用于查询所有快递
     * @param limit 是否分页标记，true表示分页，false表示查询所有快递
     * @param offset SQL语句的起始索引
     * @param pageNumber 页查询的数量
     * @return 快递的集合
     */
    List<Express> findAll(boolean limit,int offset,int pageNumber);

    /**
     * 根据快递单号查询快递信息
     * @param number 单号
     * @return 查询快递信息，单号不存在时返回null
     */
    Express findByNumber(String number);

    /**
     * 根据快递取件码查询快递信息
     * @param code 取件码
     * @return 查询快递信息，单号不存在时返回null
     */
    Express findByCode(String code);

    /**
     * 根据用户手机号查询快递信息
     * @param userPhone 手机号
     * @return 查询的快递信息列表
     */
    List<Express> findByUserPhone(String userPhone);

    /**
     * 根据用户手机号.与状态码查询快递信息  这里一般查未取件的快递信息
     * @param userPhone 手机号
     * @return 查询的快递信息列表
     */
    List<Express> findByUserPhoneAndStatus(String userPhone,int status);

    /**
     * 根据录入人的手机号码，查询录入的所有记录
     * @param sysPhone 手机号码
     * @return 查询的快递信息列表
     */
    List<Express> findBySysPhone(String sysPhone);

    /**
     * 快递录入
     * @param e 要录入的快递对象
     * @return 录入的结果，true表示成功，false表示失败
     */
    boolean insert(Express e) throws CodeException;

    /**
     * 快递的修改
     * @param id 要修改的快递id
     * @param newExpress 新的快递对象（number,company,username,userPhone）
     * @return 修改的结果，true表示成功，false表示失败
     */
    boolean update(int id,Express newExpress);

    /**
     * 跟该快递的状态为1，表示取件完成
     * @param code 根据取件码来完成
     * @return 修改的结果，true表示成功，false表示失败
     */
    boolean updateStatus(String code);

    /**
     * 根据id，删除单个快递信息
     * @param id 要删除的快递id
     * @return 删除的结果，true表示成功，false表示失败
     */
    boolean delete(int id);


    /**
     * 通过数据库  查询每个人的快递总数与人名
     * @return  返回快递总数与人名
     */
    List<Map<String, String>> findExpressRank();

    /**
     * 通过数据库  查询每个人当年的快递总数与人名
     * @return  返回快递总数与人名
     */
    List<Map<String, String>> findExpressRankYear();


    /**
     * 通过数据库  查询每个人当月的快递总数与人名
     * @return  返回快递总数与人名
     */
    List<Map<String, String>> findExpressRankMonth();
}
